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SYSTEM AND METHOD FOR BOUNDING THE LIFE OF AN EVENT 
SUBSCRIPTION TO THE AVAILABILITY OF AN OBJECT 



Inventors: Robert Fleming 
Thomas Moreau 



COPYRIGHT NOTICE 

15 A portion of the disclosure of this patent document contains 

material which is subject to copyright protection. The copyright 
owner has no objection to the facsimile reproduction by anyone of 
the patent document or the patent disclosure, as it appears in the 
Patent and Trademark Office patent file or records, but othenA^ise 

20 reserves all copyright rights whatsoever. 

[0001] This application claims priority from provisional application 
"SYSTEM AND METHOD FOR BOUNDING THE LIFE OF AN EVENT 
SUBSCRIPTION TO THE AVAILABILITY OF AN OBJECT", Application No. 
25 60/254,890, filed December 12, 2000, and which application is incorporated 
herein by reference. 

Field of the Invention : 

[0002] The invention relates generally to event notification mechanisms 
30 for use in transactional servers. 
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Background : 

[0003] Distributed Object Oriented (00) systems include the Tuxedo and 
WebLogic server products developed by BEA Systems, Inc., San Jose, 
California. In such types of systems, many types of system problems make it 
difficult, if not impossible, to distinguish between the following two cases: 
An object ceases to exist and the system hosting it is unreachable. 
• An object exists but the system hosting it is currently unreachable. 

[0004] System problems can include such factors as server computer 
failure, software processing errors, or an actual physical failure in the 
communications medium or link connecting the OO client to the object server and 
its associated events handlers. Objects that subscribe to such events and are 
then tenminated create orphaned subscriptions. These orphaned subscriptions 
consume system resources and generate system overhead, which leads to an 
overall degradation in the system performance. The degradation typically 
continues until outside intervention is used to detect and cancel the orphaned 
subscription. Such intervention typically requires the skills of an experienced 
system administrator, and often results in system downtime and a less than 
optimal use of resources. 

[0005] The Tuxedo product referred to herein is described in detail in the 
"BEA TUXEDO Reference Manual", herein incorporated by reference. The 
Object Management Group (OMG) Notification Service specification is 
described in detail in "Notification Service: OMG Technical Committee 
Document teiecom/98-06-1 5", herein incorporated by reference. The Common 
Object Request Broker (CORBA) architecture is described in detail in "The 
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Common Object Request Broker: Architecture and Specification, Revision 2.2, 
Febmary 1998", herein incorporated by reference. The CORBA Event Service 
specification is described in detail in "CORBAservice: chapter 4, Event Service 
Specification, IVIarch 1997", herein incorporated by reference. 

Summary : 

[0006] Roughly described, the invention provides a method for defining 
a Quality of Service (QOS) for a subscription that mandates an automatic 
cancellation of the subscription when the object subscriber becomes 
unreachable. In one embodimentthis QOS may be specified as transient. When 
a subscription with a QOS of transient is created the event system takes the 
following steps: 

• Periodically determine if the object is reachable. 
If the object is reachable then do nothing. 
If the object is unreachable then cancel the subscription. 

[0007] The system provided by the invention can be illustrated by analogy 
to a real-world subscription based service. Consider the scenario in which a 
mail order catalog company sends out catalogs to its mailing list customers 
every month. On occasion someone on that mailing list may move or relocate, 
and never inform the company of their change of address. If the catalogs are 
always sent by bulk mail then the post office will never tell the company if the 
catalogs are actually delivered are not. 

[0008] Most companies in this situation would like to keep their costs 
down and not send out catalogs that end up being undelivered to their proper 
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destination. Totacklethis they might employ a method such as, every January, 
instead of sending out catalogs by bulk mail, send them out by some form of 
certified mail whereby the post office is required to tell the company if the catalog 
was successfully delivered ornot. The company could then drop any customers 
5 from the mailing list whom the post office has determined and informed thatthey 
couldn't deliver the catalog to. 

[0009] This is analogous to the system provided by the invention. In 
accordance with an embodiment of the invention, when an events subscriber 

subscribes for a particular set of events (that is, when a customer requests to be 
1 0 put on a "mailing list"), the subscriber tells an events delivery system if the events 
should be delivered reliably (that is, by "certified mail"), or by best effort (that is, 
by "bulk mail"). 

[0010] If a subscriber signs up for best effort delivery, an event channel 
(e.g. the "company" sending out catalogs) sends the events to the subscriber 

1 5 using one way messages (that is, by "bulk mail"), because it's fast and doesn't 
consume many system resources. However, because of the way most traditional 
subscription based systems (including CORBA) work, the channel is nevertold 
if the subscriber has gone away, so the channel can't automatically get rid of the 
subscription. Instead, the channel ends up wasting a lot of time sending events 

20 to subscribers who no longer exist (such as the analogy in which mail catalogs 
are sent to customers who have moved or died). 

[001 1] The invention addresses the dead subscription issue by, instead 
of always sending one way messages ("bulk mail") to subscribers, the events 
channel occasionally sends two way messages ("certified mail"). If the two way 
25 message can't be delivered, then the channel assumes the subscription has died 
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and automatically removes it. A side effect of this method is that the two way 
message could fail either because the subscriber is gone forever, or because 
there is a temporary problem (such as a network problem). In either case the 
channel can't tell the difference, so it just drops the subscription. To counterthis, 
5 a best effort subscriber, being aware that the subscription might get dropped 
because e.g., the network is down, should periodically renew their subscription 
to ensure reliable reception of events. 
r | [0012] The advantage of this solution is that it automatically purges the 

St event system of orphaned subscriptions, unlike the prior solutions requiring 

I y 

1 0 manual intervention to detect and cancel such orphaned subscriptions. For each 

u event being delivered for a particular subscription, it can get expensive for the 

ill 

J " service to obtain the callback object reference repeatedly. 

[001 3] A subscription cache, which in one embodiment is an in-memory 

! '7,£ 

M map of subscription identifiers (id's) to callback object references, helps to 

Q 15 implementthedeliveryofevents more efficiently. Each callback server (nts_cb 
server) uses its own subscription cache to speed up the lookup of the callback 
for a subscription. Based on command line options, the callback nts_cb server 
creates a subscription cache with the following parameters: 

Maximum (max) number of subscription entries in the cache. 
20 • Maximum number of one-way calls to deliver events to transient 
subscribers 

Maximum time in seconds between two-way calls to deliver events to 
transient subscribers. 

25 [001 4] In accordance with one embodiment of the invention, each cache 
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entry holds the subscription id, and a corresponding callbacl<: object reference. 
[001 5] If this is a transient subscription, the following two additional fields 
are nnaintained: a) a timestamp of the last two-way call attempted to deliver an 
eventforthis subscription; and b) the count ofthe one-way calls attempted since 
5 the last two-way call. Since the nts_cb server sets up a fixed size cache, an entry 
for a particular subscription id if added, will be inserted in a corresponding slot. 
If an entry previously exists in the slot that a new subscription cache entry is being 
inserted, the previous entry is bumped off. 

10 SUBSCRIPTION CALLBACK LOOKUP 

[0016] Each time the Event Notification Service (or simply the Event 
Service) looks to find the callback object reference, it checks to locate an entry 
for this subscription id in the nts_cb server's subscription cache. If there is no 
cache entry forthis subscription, then the Event Notification Service perfonms the 
15 following steps. 

it finds the callback object reference from the subscription blob, as 
described in the previous section. 

Inserts a new entry for this subscription id in the subscription cache. 
If this is a transient subscription, the last_two_wayJime is initialized to the 
20 current time and the one_way_calLcount set to 0, so as to set up a two- 

way call. 

[0017] If a cache entry does exist forthis subscription, then the callback 
object reference is readily available. 
25 [0018] When dealing with a Transient Subscription, each subsequent 
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lookupfora certain subscription id determines whetherthe next call to deliver an 
event to the callback ought to be a two-way or one-way, based on the cache 
parameters. After each two-way call, subsequent calls to deliver the event to that 
subscriber will be one-way, until eitherthe max time between two-way calls has 
5 elapsedorthemaxnumberof one-way calls has been reached. Ifthis is a two- 
way call the oneway_count is set to 0 and the last_twowayJime set to the current 
time. If this is a one-way call, the oneway_count is incremented and 
p last_twoway_time left unaltered. A lookup is made on the subscription cache for 

this subscription. If the lookup detemiines this ought to be a two-way call, 
1 0 push_structured_event is directly invoked to deliverthe event. If an error occurs 

M during this invoke, the subscription is dropped, and the corresponding 

in 

' cache_entry is removed. Ifthis must be a one-way call however, then Dl I is use 

to invoke push_structured_event and deliverthe event. Since a one-way call was 

{ y 

hfe used, the system cannot tell if the event was delivered or not. Therefore, there is 

q 15 no need to cleanup dead subscriptions until the next two-way call. Having 

obtained the callback object corresponding to the subscription id, the event is 

delivered to the callback. 

[0019] When dealing with a Persistent Subscription, two-way calls are 
always used to deliver events to callbacks. A lookup is made on the subscription 

20 cache for this subscription. At this point the transaction is suspended. A two-way 
call (push_structured_event) is directly invoked to deliverthe event. The current 
transaction is then resumed. If an error denoting that the object no longer exists 
is returned when the event is invoked using a push_stnjctured_event, the 
subscription is dropped, and the corresponding cache_entry is removed. Having 

25 obtained the callback object con-esponding to the subscription id, the event is 
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delivered to the callback. 

[0020] In one embodiment the invention comprises a method for 
maintaining an event-based subscription by a subscriber to an events notification 
service, comprising the steps of: defining a set of best-effort delivery variables 
5 and administrative limits to be associated with a subscription to an events 
notification service; subscribing to events delivered by said events notification 
service via said subscription; periodicallycheckingthedeiivery of said events to 
said subscriber in accordance with said administrative limits; and, if said 
periodic checking of delivery of events indicates a failure in delivery then 

1 0 canceling the subscription. 

[0021] In another embodiment the invention comprises an Event Server 
system for maintaining an event-based subscription by a subscriber client 
application to an event notification and bounding the life of said event-based 
subscription to the availability of a software object at said subscriber client, 

15 comprising: an events server for receiving events from a posting client 
application and communicating said events to said subscriber client application; 
an events broker in communication with said event server, for handling a request 
for a subscription from a subscriber for event notifications and matching the 
notification of said events to said subscribers via an event service; an events 

20 service in communication with said events broker for delivering events to an 
object at said subscriber client application, and periodically verifying delivery of 
said event in accordance with administrative limits associated with said 
subscription; and, an events check timer, for maintaining a number of event 
deliveries, and communicating said number of event deliveries to said events 

25 service for use in said periodically verifying delivery. 
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[0022] In a further embodiment the invention comprises computer- 
readable instructions for bounding the life of an event-based subscription to the 
availability of an object on an Event Server, which when read and executed by a 
computer cause said computer to perform the steps of: defining a set of best- 
5 effort delivery variables and administrative limits to be associated with said 
subscription to an events notification service; subscribing to events delivered by 
said events notification service via said subscription; periodically checking the 
delivery of said events to said subscriber, in accordance with said administrative 
limits; and, if said periodic checking of delivery of events indicates a failure in 

10 delivery then canceling the subscription. 

[0023] In yet another embodiment, the invention comprises a method for 
maintaining an event-based subscription by a subscriberto an events notification 
service including a plurality of events channels, comprising the steps of: allowing 
a subscriber to create a subscription to an events channel of said events 

15 notification service, said subscription used to receive event notifications 
delivered by said events channel; delivering said event notifications to said 
subscriber via a plurality of one-way messages; periodically delivering, 
according to a set of administrative limits, said event notifications to said 
subscriber via a two-way message; and, if said periodic delivery of event 

20 notifications by said two-way message fails, then canceling the subscription. . 

Brief Description of the Drawing s: 

[0024] Figure 1 is a schematic of an Event Server system, including event 
suppliers or poster and event consumers or subscribers, in accordance with an 
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embodiment of the invention. 

[0025] Figure 2 is a flowchart of a subscription selection process in 
accordance with an embodiment of the invention. 

[0026] Figure 3 is a schematic of an Event Service in accordance with 
an embodiment of the invention. 

[0027] Figure 4 is a schematic of a dual server Event Service in 
accordance with an embodiment of the invention. 
[0028] Figure 5 is a schematic of a transient subscription mechanism in 
accordance with an embodiment of the invention. 

[0029] Figure 6 is a flowchart of a transient subscription termination 

process in accordance with an embodiment of the invention. 

[0030] Figure 7 is a flowchart of a transient subscription verification 

process in accordance with an embodiment of the invention. 

[0031] Figure 8 is a schematic of a persistent subscription mechanism 

in accordance with an embodiment of the invention. 

[0032] Figure 9 is a schematicof a subscription database in accordance 

with an embodiment of the invention. 

Detailed Description : 

[0033] The invention will now be described with reference to the 
accompanying drawings. Roughly described, the invention provides a method 
for an Event Notification Service, an Event Service, or a Notification Service to 
bind the life of a particular event subscription to the availability of a n object which 
the event depends on for proper transmission. Notification Services are used by 
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distributed servers, such as CORBA servers, examples of which are the Tuxedo 
and WebLogic Enterprise servers from BEA Systems, Inc.. Their primary 
purpose Is to notify users, applications, processes, other systems, and equivalent 
entities, commonly referred to as "subscribers," of events which those 
subscribers need or have requested notification of. Notification Services are 
described in detail in the OMG Notification Service Specification published by 
the OMG. 

[0034] In accordance with an embodiment of the invention, when an events 
subscriber subscribes for a particular set of events, the subscriber tells an events 
delivery system if the events should be delivered reliably, or by best effort. If a 
subscriber signs up for best effort delivery, an event channel sends the events to 
the subscriber using one way messages, because it's fast and doesn't consume 
many system resources. However, because of the way most traditional 
subscription based systems (including CORBA) work, the channel is never told 
if the subscriber has gone away, so the channel can't automatically get rid of the 
subscription. Instead, the channel ends up wasting a lot of time sending events 
to subscribers who no longer exist. The invention addresses the dead 
subscription issue by, instead of always sending one way messages to 
subscribers, the events channel occasionally sends two way messages. If the Iwo 
way message can't be delivered, then the channel assumes the subscription has 
died and automatically removes it. 

GLOSSARY OF TERMS 

[0035] As described herein, a "Domain Name" refers to the name of a 
particular vertical industry domain (e.g. telecommunications, finance, health 
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care). This term is defined In the Object Management Group Technical 
Committee Document on telecoms regarding Notification Service, published in 
June 15, 1998, herein incorporated by reference as the OMG Notification 
Service Specification. The OMG Notification Service Specification is used to 
describe a field in Common Object Services (COS) Structured events. 
[0036] An "Event Broker'' refers to any system or server that handles 
requests for subscriptions, an example of which is the TUXEDO Event Broker 
from BEA Systems, Inc. The Event Broker typically runs on an Event Server, 
[0037] An "Event Repository" comprises a repository of metadata 
pertaining to COS events. This concept is further described in the OMG 
Notification Service Specification. 

[0038] An "Event Service", "Event Notification Service", or "Notification 
Service" is any process running on or in communication with an Event Server that 
handles the notification of events. Event Servers that may be used with the 
invention include the WebLogic Enterprise Server from BEA Systems, Inc. 
[0039] A "Structured Event" is a COS Structured Event as defined by the 
OMG Notification Service Specification. Structured Events contain a Fix header, 
Variable header, Filterable body parts and a Remaining body. 
[0040] The programming model for one embodiment of the Event Service 
as described herein is based on the CORBA programming model. There are 
two sets of interfaces. One set of interfaces is a minimal subset of the CORBA 
Notification Service. The other is a proprietary interface designed to be easy to 
use. Both interfaces support standard structured events as defined by the 
CORBA Notification Service. 
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[0041] The Event Service described here is not merely an instance of 
eitherthe standard CORBA Event Service, or the standard CORBA Notification 
Service, but In some embodiment may be compatible with both. The following 
is a list of limitations observed by an embodiment the Event Server: 
5 • The maximum size for an event name is 32 bytes. 

The maximum size of a filter constraint is 256 bytes. 

Event priority is restricted to the range 1-100. 

[0042] The Event Broker provides a complete and useful set of 
1 0 capabilities that support the development of applications that require events 
notifications via an Event Service. 

[0043] Applications that will use this Event Service do not require the 
performance generally offered by a real-time messaging service. The Event 
Service described here is designed to provide reliable, durable events. These 

1 5 design goals are often in conflict with performance. To counter this the useful 
parts of the original CORBA specifications are used as appropriate, and novel, 
proprietary extensions are added, pari:icularly when they facilitate ease-of-use. 
[0044] Real-time event systems are designed to process high volumes of 
events with minimal system overhead or delay. The delivery guarantees tend to 

20 be weak. As such this specification is not for a real-time event system as typically 
defined, but instead for a hybrid approach that optimizes reliability of 
transmission and low system overhead. 

[0045] Event systems that offer various delivery guarantees require input 
and output of events data (I/O) to secondary storage, typically a disk drive or an 
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equivalentform of permanent memory system. This has a significant impact on 
performance and throughput. The invention conversely is directed to an event 
system offering delivery guarantees, but with minimal performance impact. 
[0046] Figure 1 shows a schematic of an event push/pull mechanism in 
5 accordance with the invention. There are three basic components in the system 
100: 

The Supplier, 
The Consumer, and 
• The Event Broker, also known as the event channel. 

10 

[0047] The Supplier 1 04 is the producer of events. It creates events, and 
posts them to the Event Broker 1 02. The Consumer 106 Is the recipient of the 
events. It connects to the Event Broker, and subscribes to a set of events. When 
the Event Broker 1 02 receives an event that matches a Consumers subscription 
15 it delivers or makes available to the Consumer 106 that particular event. In most 
instances the Event Broker is a server or process running on an events server. 
An example of an events server that can be used with the invention is the 
Weblogic produced from BEA Systems, Inc. 

[0048] There may be many Suppliers 1 04 and Consumers 1 06. Logically 
20 there is often only one Event Broker, although strictly speaking this is not true 

since Event Brokers can be replicated. Nonetheless, from either a Consumer or 

a Supplier point of view there appears to be only one. 

[0049] Consumers 1 06 must select one of two event delivery paradigms, 

push 1 1 0 or pull 1 1 2. 1 n one embodiment of the invention only the push model is 
25 supported. The Event Broker pushes events to the Consumer by calling a 
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method in the Consumer. The Consumer pulls events from the Event Broker by 
calling a method In the Event Broker. Depending on the quality of service 
selected, the event might be stored durably pending delivery to the Consumer. 
[0050] Suppliers use a push paradigm 1 08. They call a method (named 
push) in the Event Broker. The Event Brokertakes responsibility forfiltering and 
delivering the event. Consumers may specify a Quality Of Service (QOS) which 
effects the persistence of the Consumers subscription and, in the case of push 
Consumers, whether or not events delivery is retried following a failed delivery. 
There is no direct association between Suppliers and Consumers. At any point 
in time there may be zero, one or many Suppliers and/or Consumers. The Event 
Service provides a variety of interfaces (described in detail below) to allow a 
subscriber or poster to interact with the Event Server and to post or receive 
events. 

[0051] In a Tuxedo type system, the Events Service is layered on top of 
TUXEDO Event Broker. In this implementation the M3 Events Service uses the 
following functions: 

When an event is posted, it is converted to an Event Broker event and 

tppostO is called to post it. 

When an event subscriber subscribes, the subscription is converted to 
an Event Broker subscription and tpsubscribe() is used to subscribe, 
having Event Broker deliver the event back to the Events Service. 
When EventBrokerdeliversaneventtotheEventsService,theeventis 
converted to an Event Server event , and delivered to the subscriber. 
When a subscriber unsubscribes, the con-esponding Event Broker 
subscription is removed via a call to tpunsubscribeQ. 
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PERSISTENT AND TRANSIENT SUBSCRIPTION SELECTION 
[0052] Figure 2 shows a flowchart of a process by which a subscriber 
chooses between a transient and a persistent subscription. As shown in Figure 
2, the subscriber, typically an application or server process, requests in step 1 72 
a subscription to an Event Server (such as a Weblogic or Tuxedo server) via the 
Event Service. The request will denote (step 1 74) which type of subscription is 
required. If the subscriber wants a persistent subscription to the Event Server 
then a persistent subscription is created (step 1 76). Conversely, if the subscriber 
wants a transient subscription to the Event Server then a transient subscription 
is created (step 1 78). The distinction between these two types of subscription, 
and how the invention handles them differently, is discussed in detail below. 
[0053] Persistent Subscriptions provide strong guarantees about event 
delivery, and the permanence (i.e. the degree to which the system maintains the 
subscription in its subscription database) of the subscription. These 
characteristics come with a cost. Since Persistent Subscriptions must typically 
be stored a permanent or durable storage, the use of Persistent Subscriptions 
consumes more system resources (disl< space, CPU cycles, etc.), and requires 
more administration (managing queues, detecting dead subscribers, etc.). 
Subscriptions with a persistent QOS exhibit the following properties: 

The subscription is in effect until an unsubscribe operation is performed. 
Event delivery is retried until either the event is delivered or an 
administrative retry limit is exceeded. When the event retry limit has been 
exceeded the event is moved to an error queue. An administrator can 
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move events from the error queue back to active queue where delivery 
attempts will restart. 

[0054] Transient Subscriptions provide the best performance with the 
5 least overhead. Events are delivered on a best effort basis where best effort is 
defined to be a single delivery attempt On detection that the Consumer is 
unavailable the subscription is tenminated. Subscriptions with a transient QOS 
exhibit the following properties: 

The subscription is in effect until a failed event delivery is detected. On 
10 detection of a failed delivery the subscription is terminated. Note, this is 

not necessarily on the first failed delivery. Periodically the system will take 
measures to check to see if a delivery is successful. It Is only during these 
periodic checks that delivery failure detection occurs. 
Event delivery is attempted exactly once. If the attempt fails, the event is 
15 lost 

EVENT TYPES 

[0055] All events pushed by Suppliers, or delivered to Consumers are 
COS Structured Events, that is, they conform to the definition of Structured 
20 Events as specified by the COS Event Service (detailed further in the OMG 
Notification Service Specification). If the events are to be filtered based on 
content (versus filtering on domain and type), then additional restrictions apply. 
The restrictions apply to data types and filtering based on event content, and are 
explained below: 
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• The Fixed Header section consists of three fields: domain_type, 
event_type and an event_name. 

The Variable Header consists of a single name/value (NV) pair, namely 
Priority. Priority is used internally to the system to prioritize the 
5 processing of events. There is no guarantee that higher priority events will 

in fact be given priority over lower priority events. 
The Filterable Body consists of zero or more NV pairs. 
The Remaining Body consists of a single ANY. 

1 0 [0056] To allow subscribers to filter on content, or to allow applications 
to subscribe to Event Server events and view these fields, the administrator 
creates Field Manipulation Language (FML) field table files to define these 
fields. These field tables form a repository, not to be confused with the events 
repository discussed in the OMG Notification Service Specification. A structured 

1 5 event's filterable_data section contains a list of name/value pairs. An event's 
data is typically stored in this list. The field names in the FML field table files must 
match the name in the structured event. The field type can be any allowable FML 
type (long, short, double, float, char, string, carray). The value in the structure 
event must be the same type as defined in the field table. 

20 [0057] System events are generated by the system. They are not 
generated by applications. These events are mapped in COS Structured Events. 
User events can be posted by applications and received by Event Server 
applications. The table below shows how the structured event is fabricated. 

25 

Atty Docket No.: BEAS-01045US1 SRM/KFK Express Mail Label No.: EL622695725US 

kfk/beas/1 045/1 045us1 .app.wpd 



-19- 

EVENT SERVICE 

[0058] An Event Service allows one application to post an event (poster) 
and many otfier applications to receive the event (subscribers). The Event 
Service acts as an internnediary, receiving the posted event and forwarding it to 
interested subscribers. It allows for decoupled communication between posters 
and subscribers. 

[0059] Figure 3 shows the traditional interaction between the poster, 
subscriber events service, and events broker. As shown in Figure 3, a poster 
1 24 posts (11,12) events to an Event Server via an Event Broker 120 and an 
events service 122. Subscribers 126, conversely subscribe to the Event Sen/er 
to receive (1 3, 14) notification of events. Each Event Server event subscription 
is converted into an Event Broker subscription. Similarly, each posted Event 
Server event is converted into an Event Broker posting. The Event Brokerthen 
decides which subscribers should receive the event (filters & fans out) and 
delivers them to the Events Service. The Events Service fonwards them on to the 
subscribers. If a subscriber requests guaranteed delivery of events, then the 
Event Broker can include a queue. The process is used during a typical 
past/subscribe process is a s follow: (using a CORBA poster/subscriber as an 
example). 

1. The poster invokes a CORBA method to post a COS Notification 
structured event to the Event Server. 

2. The Events service reports this event as an Event Broker event. 

3. The Event Broker decides which subscribers should receive the event, 
and then invokes a Tuxedo or an equivalent Event Service in the Events service 
(once per subscriber). 
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4. The Events service converts the Event Broker event back to a COS 
Notification structured event and then delivers it to the subscriber by invoking a 
CORBA method on a callback object provided by the subscriber. 

[0060] The Event Server delivers events to a subscriber by invoking a 
CORBA method on a CORBA callback object implemented by the subscriber. 
Therefore, in this example the subscribers are likely to be other CORBA servers. 
[0061] The invention provides two qualities of service for event delivery: 
transient and persistent. In accordance with the invention the Event Service tries 
to deliver an eventto a transient subscriber exactly once. If the delivery fails, the 
event is dropped. The Event Service keeps trying to deliver an event to a 
persistent subscriber until the event is successfully delivered. It uses/Q queues 
to help with this. 

[0062] As illustrated in Figure 4, the Event Service 122 can be split 
across two servers. The first server instance "nts" 130, implements all the 
CORBA event interfaces. The second server instance, named "nts_cb" 132, 
implements services that fonvard events to callback subscribers. It acts as a 
CORBA server in addition to being a CORBA client. Using two servers instead 
of a single server in this manner improves overall performance. 

TRANSIENT SUBSCRIPTION.^ 

[0063] Figure 5 shows a transient subscription process in accordance 
with the invention. As before the poster 1 24 posts events to the Event Server via 
an Event Service 122 and Event Broker 120. For transient subscriptions, the 
Event Broker delivers these events directly to a callback service in the "nts cb" 
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server. This service then forwards the event to the subscriber. Some points to 
note about the Event Broker as it pertains to transient subscription include: 

1 . The application posts (2 1 ) a structured event to the Event Server Event 
Service (either in a transaction or not) via the "nts" server 1 30. 

2. The Event Server Event Service converts the structured event to an 
event buffer and uses "tppost" to post (22) the event in the Event Broker typically 
within the application transation. Atimestanfipfield is added to the buffer(toald 
with administration). 

3. The Event Broker filters the event and fans it out the subscribers. 
Events for transient subscribers are delivered to the events service in the 
"nts_cb" server 1 32 via a one way message (23). A flag is set when subscribing 
that tells Event Broker to attach a field to the event buffer. That contains the 
subscriber's subscription id. Regardless of whether or not the application posted 
in a transaction, the events are delivered outside of the transaction. 

4. The "nts_cb" server 132 converts the event bufferto a structured event. 
It also retrieves the subscriber's subscription id from the buffer. It looks up the 
callback object reference for that subscriber (given the subscription id). The 
event is then delivered (24) to the subscriber, for example by invoking a CORBA 
message on the callback object. 

[0064] Transient subscriptions have two requirements. The first is that 
they be as fast as possible. The second is that dead subscriptions are detected 
and automatically removed. Events are delivered more quickly If one way 
messages are used. However, since one way messages don't return en-ors. 
[0065] If two way messages are used, then errors can be detected and 
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thus dead subscriptions can be found and removed. However, two way 
messages don't perform as efficiently. Rather tfian choosing simply between 
good performance and good cleanup, the invention uses a hybrid approach. In 
accordance with the invention, one way messages are usually used (for better 
perfonnance), but occasionally a two way message is used (for error or failure 
detection). The administrator (for example via a number of command line 
options to the "nts_cb" server) can specify administrative limits on the 
subscription, such as the maximum number of consecutive one way messages 
that may be delivered between two way messages, the maximum time between 
successive two way messages, or the maximum time to wait for a response to 
a two way message. Typically, the first event for a subscriber is delivered with 
a two way message. Thereafter, events are delivered using one way messages 
until one of the administrative limits has been reached (for example, the 
maximum numberofconsecutive one way messages). Atthatpointanewtwo 
way message Is sent to check the validity of the subscription. Depending on the 
success of that two way message the system may then reset any timers 
associated with that subscription. One way messages are again sent, and when 
(any or all of) the limits have again been reached, anothertwo way message is 
used and the cycle repeats. If a two way message is sent and fails, then the 
system assumes that subscription has died, and it is removed. 
[0066] Figure 6 shows a flowchart of a process by which a system 
incorporating the invention checks for a valid transient subscription, and 
terminates those subscriptions that it finds no longer valid. In step 182, the 
process begins with a subscriber requesting a transient subscription. The system 
interprets a set of best effort delivery variables, similar to Quality of Service 
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variables, which are used to define standards for event delivery. A system 
administrator can specify or tune these best effort delivery variables to be 
optimized to ensure a standard of delivery appropriate to the subscribers needs 
orQOS requirements. For example, considering the requirements of a real-time 
5 stock-price or stock-quote application, the events (changes in stock prices) 
should be transmitted as rapidly as possible. Otherapplications such as weather 
update systems may not need such a high standard of event delivery. The 
administrator can specify a set of best-effort delivery variables for each type of 
application or subscriber handled by the Event Server. In step 1 84, these best- 

1 0 effort delivery variables are read or retrieved, and used to create (step 1 86) a 
transient subscription for this subscriber. In step 1 88, the subscriber proceeds 
to subscribe, and receive, posted events. A periodic check is made in step 190 
to ensure that the event delivery to this subscribed falls within the best effort 
delivery variables and administrative limits specified by the system when the 

15 subscription is created. If the event delivery is within the settings, then the 
subscription is maintained. If however the event delivery falls outside the best 
effort delivery variables or administrative limits, then the subscription is 
terminated (step 1 92), and cleaned-up (step 1 94) to conserve resources such as 
sockets and memory. 

20 [0067] Figure 7 shows a flowchart illustrating a more detailed view of one 
implmentation of the best effort delivery process used by the invention, in which 
the Event Server uses an event delivery timer to track the status of the delivery 
on a periodic basis, and to take action when delivery falls outside of the best- 
effort: delivery variables or administrative limits. In step 202, the subscriber 

25 subscribes to events via a transient subscription. In step 204 the event delivery 
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timer is initialized, with an initial value for event check = 1 . The subscription is 
then maintained as each event is delivered (step 206) using a single message 
process. In step 208, as each event delivered, the event check timer is 
incremented. A system administrator can preset a maximum value forthe event 
checktimerthat is appropriate forthe QOS and optimization reasons. When the 
event check timer reaches this maximum value (step21 0) it checks forthe status 
of the transient subscription by sending a two-way event delivery (step 21 2). If the 
two-way message fails (step 21 4) , then the system assumes the subscription is 
no longer valid, and it is terminated (step 216) and cleaned-up, as described 
above. 

PERSISTENT SUBSCRIPTIONS 

[0068] Figure 8 shows a persistent subscription process in accordance 
with the invention. As with the invention. As with the transient subscription the 
poster 1 24 posts events to the Event Server via an Event Service 1 22 and Event 
Broker 1 20. For persistent subscriptions however, the Event Broker 1 20 delivers 
(33) the event to a /Q queue 1 52 for storage (34) in a persistent queue 1 56. The 
Q fonwarder 154 periodically polls (35) this queue. When it finds an event, it 
Invokes a service (36) In the "nts_cb" server. This service then forwards (37) the 
eventto the persistent subscriber 1 50. If the event isn't successfully delivered, 
the Q fon/varder 1 54 puts the event back on the queue. This ensures that delivery 
will be retried until the event is successfully delivered. Some points to note about 
the Event Broker as it pertains to persistent subscriptions include: 

1 . The application posts a structured event to the Event Server event 
service (either in a transaction or not). 
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2. The Event Server Event Service converts the structured event to an 
event buffer and uses "tppost" to post the event. It posts in the application's 
transaction (or none). A timestamp field is added to the buffer (to aid in 
administration). 

3. The Event Broker filters the event and fans it out the subscribers. 
Events for persistent subscribers are enqueued via "tpenqueue" (an Event 
Broker implementation detail). The event in enqueued once per subscriber (vs. 
once per event). Aflag is set when subscribing that tells Event Brokerto attach 
to the event buffer, a field that contains the subscriber's subscription id. If the 
application posted in a transaction, the event is enqueued in that transaction. If 
the enqueue fails, then the transaction is roiled back. If the application doesn't 
post in a transaction, a new transaction is started for each enqueue (one per 
subscriber). If an enqueue fails, an en-or is logged. However, the poster is not 
informed of the error. 

4. The /Q manager writes the event to the queue. 

5. The Q forwarderwakes up (the administrator controls howoften)and 
polls the queue to see if there are events to deliver. 

6. The Q forwarder begins a transaction (one per event per subscriber) 
and invokes a service in the "nts_cb" server to deliver the event. If the service 
doesn't return successfully, then the transaction is aborted and the event is 
requeued for later delivery (within administrative retry limits). 

7. The "nts_cb" server converts the event bufferto a stnjctured event. It 
also retrieves the subscriber's subscription id from the buffer. It looks up the 
callback object reference for that subscriber (given the subscription id) and 
Invokes a two way message on that object to deliver the event. If the message 
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fails, then the service fails (in which case the transaction may be rolled back and 
the event retried later). When using I lOP and CORBA messaging the transaction 
is suspended while the message is delivered, since outbound HOP doesn't 
support transaction propagation outside the cloud. 

5 

PERSISTENT STORAGE 

[0069] Figure 9 shows an embodiment of a persistent storage for use 
with the invention. The Event Service creates an Event Broker subscription for 
each Events subscriber (COS Notification or Simple Events). It also records its 

1 0 subscription state in the Event Broker database. Subscribers are returned their 
corresponding Event Broker subscription identifier or id when they subscribe. 
They hand this id back to the Event Service when they wish to operate on their 
subscription. This ties the subscriber to their Event Broker subscription. 
[0070] COS Notification subscribers are also returned a subscription 

1 5 object reference. The corresponding Event Broker subscription id is imbedded 
in the subscription object reference's object id. When the subscriber invokes a 
method on the subscription object, the Event Server retrieves the Event Broker 
subscription id from the object id. Again, this ties the subscriber to the 
corresponding Event Broker subscription. 

20 [0071] Based on command line options, the callback nts_cb server 
creates a subscription cache with the following parameters: 

Maximum (max) number of subscription entries in the cache. 
Max number of one-way calls to deliver events to transient subscribers. 
• Max time in seconds between two-way calls to deliver events to transient 

25 subscribers. 
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[0072] In accordance with one embodiment of the invention, each cache 
entry holds the subscription id, and a con^esponding callback object reference. 
If this is a transient subscription, the following two additional fields are 
maintained: a) a timestamp of the last two-way call attempted to deliver an event 
for this subscription; and b) the count of the one-way calls attempted since the 
last two-way call. Since the nts_cb server sets up a fixed size cache, an entry for 
a particular subscription id if added, will be inserted in a corresponding slot. If 
an entry previously exists in the slot that a new subscription cache entry is being 
inserted, the previous entry is bumped off. 

[0073] The Event Broker allows subscribers to attach a generic "blob" 
(string) to a subscription. The blob is stored persistently in the Event Broker 
database and can be looked up via a Management Infomiation Base (MIB) given 
a subscription id. The Event Server Event uses this feature to store its 
subscription information. For example, callback object references for 
subscriptions are stored in the blob. 

SCALING AND PERFORMANCE 

[0074] The Event Service provided by the invention does not have a single 
point of failure, and is designed for maximum parallelism. In this regard, the 
following features may be implemented. 

The "nts" and "nts_cb" servers are designed to be as stateless as 
possible. Any "nts" server may create new subscriptions, post events and 
unsubscribe any existing subscription. Similarly, any "nts_cb" server may 
delivery any event to any subscriber. Because these servers are 
"stateless", the administrator may replicate them. 
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Administrators may also replicate Event Broker and /Q servers (Since 
Event Brokers share a database, subscriptions are not lost if an Event 
Broker server dies. Similarly, since /Q servers share a database, 
persistent events are not list if a /Q server dies). 
5 • Most Event Server CORBA object implementations use system objects 
to improve performance. 
Administrators may use more than one Q space. 
Events are delivered to transient subscribers via a combination of "one 
wa/ and "two way" messages to improve or optimize performance and 
10 error detection. 

ADMINISTRATION 

[0075] In a Tuxedo implementation, the administrator must start the 
following servers (only servers in addition to those needed to mn Event Server 
15 are listed here): 

TMUSREVT (the user Event Broker server). 

"nts" server (handles posting and un/subscribing). 

"nts_cb" server (handles delivering events to subscribers). 

20 [0076] The "nts_cb" server keeps a fixed size cache in memory mapping 
subscription ids to callback object references. This is used to increase 
performance. The administrator can control the size of this cache via the "-s size" 
command line option to the "nts_cb" server. It specifies how many of these 
mappings maybe retained in memory. The default value is 1000. Normally, each 

25 "nts_cb" server has its own work queue of events to deliver (note: this queue 

Atty Docket No.: BEAS-01 045US1 SRM/KFK Express Mail Label No.: EL622695725US 

kfk/beas/1 045/1 045us1 .app.wpd 



-29- 

contains a list of service calls to perfonn - it is not a /Q queue containing events 
to deliver). This can be a problem, in that, if an "nts^cb" server is delivering an 
event to a subscriber, and the subscriber's callback method takes a long time to 
process the event, all the other events in that "nts_cb" server's work queue are 
5 stuck waiting. The administrator may avoid this by configuring an MSSQ set for 
the "nts_cb" servers (see the tuxedo documentation for instructions). This allows 
them to share a single work queue. As soon as any "nts_cb" server frees up, the 
next event on the work queue is delivered. 

[0077] For Transient Subscribers, the administrator may set command 
1 0 line parameters to the "nts_cb" server which control the frequency of two way 
versus oneway messages used to deliver events to transient subscribers. The 
parameters are; 

• -c count: specifies the maximum number of consecutive one way 
messages that will be sent to a transient subscriber. The default value is 
15 10 messages. If this limit is exceeded, the next event will be delivered via 

a two way message. 

-t time: specifies the maximum time that consecutive one way messages 
will be sent to a transient subscriber. The default value is 300 seconds (5 
minutes). If this limit is exceeded, the next event will be delivered via a 
20 two way message. 

[0078] For Persistent Subscribers, the administrator must configure a 
queue for the events. This entails using "qmadmin" to: 
Create a disk device for the qspace. 
25 • Create a qspace using that device. 
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Create two queues within that qspace. The first, called "NTS_PERS", is 
where the events are delivered. The administrator can control how the 
time between retries as well as the number of retries when creating the 
queue. The second queue, called "NTS_ERRORS", is the error queue. 
5 Events that cannot be delivered within retry limits are deposited here. 



[0079] The administrator must start the TMQUEUE and TMQFORWARD 
servers. Specify the "-s MY_QSPACE_NAME:TMQUEUE" option when starting 
TMQUEUE. Specifythe"-q NTS^PERS" option when starting TMQFORWARD. 

1 0 The administrator must configure a null transactional group and run TMUSREVT, 
TMSYSEVT, nts and nts_cb in that group. The administrator must configure a /Q 
transactional group. This group must use the device and qspace created by 
"qmadmin". TMQFORWARD and TMQUEUE must run in this group. The 
administrator must also configure a transaction log. 

15 [0080] Administrators may configure more than one qspace (and the 
corresponding group and servers) to avoid having a single point of failure. 
Each "nts" server is assigned a "birth" qspace. Whenever that server creates a 
newsubscription, the new subscription is assigned to this qspace, Thishelpsto 
spread out the subscriptions over the available qspaces. All of that 

20 subscription's events will be delivered via that qspace, though any "nts_cb" 
server can deliver the event to that subscriber 

[0081 ] The administrator can control an "nts" server's birth qspace via the 
"-S space" option, "space" is the name of the qspace. The default value is 
"NTS_QSPACE". 

25 
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DATA FILTERING AND EVENT BROKER INTEROPERABILITY 
[0082] A structured event's "filterable.data" field contains a list of 
name/value pairs. An event's data is typically stored in this list. A structured 
event's Variable Event Header field also contains a list of name/value pairs. 
5 Typically, tine Variable Event Header is used to specify per event delivery criteria 
(eg. Priority). To either allow subscribers to filter on these fields (Filterable Data 
or Variable Event Header), or to allow Tuxedo applications to subscribe to Event 
Server events and viewthese fields, the administrator must create FML32 field 
table files to define these fields, and configure the "nts" and "nts_cb" servers to 

1 0 access these files. 

[0083] The field names in the FML32 field table files must match the name 
in the structured event. The field type can be any allowable FML32 type (long, 
short, double, float, char, string, canray). The value in the structure event must be 
the same type as defined in the field table. The administrator must use the 

1 5 FLDTBLD1R32 and FiELDTBLS32 environment variables to make these field 
table files available to the "nts" and "nts_cb" servers. 

CLEANUP MECHANISMS 

[0084] Applications using the Events Service have some responsibilities. 
20 For example, subscribers must eventually unsubscribe. However, not all 
applications are well behaved. The Events Sen/ice provides manual and 
automatic cleanup mechanisms to help recoverfrom application errors so that 
an errant application doesn't affectthe performance of the entire Events Service. 

25 



Atty Docket No.: BEAS-01045US1 SRM/KFK 
Icfk/beas/1045/1045us1 .app.wpd 



Express Mail Label No.: EL622695725US 



-32- 

Automatic Cleanup Mechanisms 

[0085] If the Event Server receives an exception that an object no longer 
exists, for examplea CORBA::OBJ_NOT_EXIST exception when delivering an 
event to a subscription, then it automatically drops the subscription. However, in 
the typical instance an ORB cannot raise this exception, therefore this cleanup 
mechanism isn't very reliable. Occasionally, the "nts_cb'' server uses a "two way" 
invoke to deliver an event to a transient subscriber. If an exception is returned, 
then the subscription is automatically dropped. This is the most reliable 
automatic cleanup mechanism provided by the invention. The decision to use a 
"two way" invol<es at a certain time may be made by maintaining an event_checl< 
timer that is incremented after each "oneway" invoke. When the timer reaches 
a certain pre-set or maximum number, the "two-way" invoke is issued to verify the 
event delivery. Subscribers should ideally use transient best effort callback 
subscriptions whenever possible. 

Manual Cleanup Mechanisms 

[0086] All events for guaranteed delivery subscribers are sent to /Q 
queues. These events are time stamped and tagged with the subscription id of 
the subscriber. These queues have retry parameters. When an event has 
exceeded the retry limits, it is moved to an error queue. Subscribers are allowed 
to attach an administrative name to their subscription. The Event Server 
provides an administration tool which allows administrators to peruse the event 
queues, based on subscription id, subscription name and/or event age. The 
administrator can purge old events or move events from the error queue back to 
the delivery queue to try sending them again. The administration tool also lets the 
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administrator browse and remove subscriptions based on subscription id and/or 
subscription name, and uses the Event Broker and /QMIBS to find subscriptions 
and queued events. It also uses the subscription's "blob" to find its administrative 
name and subscription type. 

RUNTIME SUBSCRIPTION SCENARIOS 

[0087] If a subscriber goes away without unsubscribing, and events still 
occur which match the dead subscription then the invention handles the 
subscription in a variety of different ways. 

Persistent subscriber: the events eventually end up in the error queue. 

Use Event Server eadmin to detect and cleanup. 

Transient subscriber: eventually "nts_cb" will get an error when delivering 

an event and automatically drop the subscription. 

[0088] If a subscriber goes away without unsubscribing, and no more 
events occur which match the dead subscription, then thee is no indication other 
than degraded perfomiance (all events are compared against all subscriptions 
to see if they should be delivered) that this has occunred. The Event Server 
administration tool can be used to browse and cleanup these subscriptions. 
[0089] COS Notification requires multiple invocations on multiple objects 
to create a subscription. As a result, process-bound objects must be used. If a 
subscriber goes away without completing the subscription, then these objects 
collect in the "nts" server's memory. No mechanism is provided to detect and 
cleanup this problem. The administrator's only recourse is to notice that the 
process size has grown, then shut down and restart the offending "nts" server. 
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[0090] If events cani be delivered to a persistent subscriber because the 
network is down, then the events will accumulate in the error queue. The 
administration tool can be used to find these events and purge them or move 
them back the callback queue. 

Transactions 

[0091] Sending and receiving events use one set of transactional 
semantics while subscribing and unsubscribing use another Posters may 
choose to use a transaction or not. Subscribers are NOT called within a 
transaction. The various transaction scenarios handled by the invention are 
outlined below: 

Post within a transaction, transaction committed 

[0092] The event is guaranteed to be delivered to persistent subscribers 

and might be delivered to transient subscribers. 

[0093] Persistent Subscriber: The event is either delivered to the 
subscriber or put on the error Q, It may be delivered more than once. It is 
delivered outside the context of a transaction . If the callback method raises an 
exception, then the event will be delivered again (up to the retry limit the 
administrator set for the queue). If the callback method successfully returns, 
normally the event is considered delivered. However, It is possible, since the 
event is delivered outside a transaction, that Event Server (MS) Events receives 
an enror and redelivers the event. 
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[0094] Transient Subscriber: The event may be delivered to the subscriber 
(at most once). 

Post within a transaction, transaction rolled back: 
5 [0095] The event is guaranteed to NOT be delivered to persistent 
subscribers and PROBABLY WILL be delivered to transient subscribers. 
[0096] Persistent Subscribers: Since Event Broker delivers the events to 
a queue within the scope of the poster's transaction, the events never get on the 
queue if the transaction is rolled back. Therefore, they are never delivered to the 
10 subscriber. 

[0097] Transient Subscribers Event Server Events makes transient 
delivery as lightweight as possible. It does this by delivering the events to a 
tuxedo service outside the scope of the poster's transaction. This allows the 
Event Broker to use a "one way" message to deliver the event to this service 

1 5 (very lightweight). Similariy, this service uses a "one way" invoke to deliver the 
event to the subscriber. Since the Event Broker delivers the event immediately 
(instead of waiting to find out if the transaction is rolled back), and since the 
Event Server doesn't want the overhead of storing the events until the transaction 
is rolled back or committed, events are delivered to the subscribers immediately. 

20 Therefore, transient subscribers may receive "phantom events"-events that are 
posted within a transaction which is subsequently rolled back. If this behavior 
isn't acceptable, then the subscriber should choose persistent delivery (or the 
poster must be changed to not post within a transaction). 



Atty Docket No.: BEAS-01 045US1 SRM/KFK 
kfk/beas/1 045/1 045us1 .app.wpd 



Express Mail Label No.: EL622695725US 



-36- 

Post outside a transaction 

[0098] Event Server Events posts the event to Event Broker outside the 
scope of a transaction. Event Broker delivers the event to a queue for each 
persistent subscriber This delivery uses autotran (a separate transaction for 
each subscriber). It also uses non-transactional "one wa/ messages to deliver 
the events to transient subscribers. 

Post Succeeds 

[0099] The event has been fanned out to each subscriber that should 
receive it. The event may or may not have been delivered yet. That is, the event 
has been sent on its way, but might not have gotten there yet. Delivery to a 
subscriber may fail. 

Post Fails 

[0100] This means that no subscribers have received the event. 
Subscribing / Unsubscribing 

[01 01] The event Broker's subscription database is not transactional, and 
therefore subscribing and unsubscribing are nottransactional. Applications are 
expected to un/subscribe outside the context of a transaction. If an application 
tries to un/subscribe within a transaction, the transaction is ignored and the 
change is permanently made. 
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EVENT SERVICE INTERFACES 

[01 02] The Event Service supports a variety of Interfaces including the two 
described herein. One is based on the CORBA Notification Service (as 
described in the OMG Notification Service Specification). The other is an 
alternative proprietary interface designed to be easier to use. Both interfaces 
pass structured events as defined by the OMG Notification Service Specification. 

1 . Simple Events Interface 

[0103] One embodiment of the events interface, the Simple Events 
Interface (SEI) is designed to be the primary interface for Event Server events. 
Simplicity and ease-of-use are the defining characteristic of this interface. 
[01 04] The SEI interface is based on a push model. Suppliers push events 
to the system, and the system pushes events to the subscribers. In this 
embodiment there is no provision for pulling events. For Suppliers the inherent 
inefficiencies of pulling events make it an unattractive option. For Consumers 
there are three contradictory issues: 

1 . Dead pull Consumers clog the system with unwanted events. There is 
no way to determine when a Consumer is dead rather than just lazy or 
busy. This situation creates an administrative headache. 

2. There is no way to do a blocking pull. Forcing Consumers to poll is 
burdensome and inefficient. 

3. Events waiting to be pulled need to sit somewhere, and that pretty 
much means they need to be queued. Since queues are difficult to configure and 
manage, this introduced excessive complexity given that the application had no 
other requirements that mandated the use of queues. 
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[0105] The SEI application program interface (API) is provided by the 
following interfaces: 

Tobj_SimpleEvents: ■.Channel, 
• Tobj_SimpleEvents:ChannelFactory, and 
5 • CosNotifyComm::StructuredPushConsumer interfaces. 



CHANNEL INTERFACE 

[01 06] The Channel interface is used by Consumers to subscribe, and 
unsubscribe to events, and by Suppliers to post events. It contains three 
10 . operations; subscribe, unsubscribe, and push_structured_event. 



subscribe 

[0107] The syntax of the subscribe operation is shown below: 



15 SubscriptionID subscribe ( 

in Tobj_events: : Subscript ionType sub^type, 

in string subscript ion__naTne, 

in RegularExpression domain, 

in RegularExpression type, 

20 in FilterExpression data filter, 

in CosNotifyComm: : StructuredPushConsumer push_Consumer 

); 



[01081 The subscribe operation is used to enter a subscription fora push 
25 Consumer. The subtype name, subscription name, domain name, type name, 
filter expressions, and the object reference of the push Consumer object are 
passed in. 
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[0109] The sub^type parameter specifies the desired quality of service. 
It can take the value Tobj„Events::TRANSIENT_SUBSCRIPTION, or 
Tobj_Events::PERSISTENT_SUBSCRIPTION. 

[0110] The subscription_name parameter specifies a name that is used 
5 by an administerto identify the subscription. Applications should use names that 
are meaningful to a system administrator since this will be the primary way that 
an administrator associates a user with a subscription and the events that result 
from it. This parameter is optional (i.e., an empty string can be passed in). The 
domain and type fields are defined in the OMG Notification Service 

10 Specification. 

[0111] The push_Consumer is the object that will be called when a 
structured event is delivered . In general, persistent object references should be 
used when the sub^type is setto Tobj_Events::PERSISTENT_SUBSCRIPTION, 
and transient object references should be used when the sub__type is set to 

15 Tobj_Events::TRANSIENT_^SUBSCRIPTION. 

[0112] The life of the subscription is a function of the QOS, and potentially 
other factors. On return, a unique subscription identifier Is passed back. The 
effect of this operation is not instantaneous. There can be a brief delay between 
returning from this operation, and the actual start of event delivery. 

20 

unsubscribe 

[0113] The syntax of the unsubscribe operation is shown below: 

void unsubscribe ( 

in Subscript ionID id 
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[0114] The unsubscribe operation is called by tfie client to terminate a 
subscription. On return from this operation, no further events will be delivered. 
There is one input parameter, a SubscriptionlD. This operation is not 
instantaneous. After retuming from this operator a Consumer may continue to 
receive events for a brief period of time. 

push_structured_event 

void push_structured event ( 

in CosNotification: rStructuredEvent event 

( ; 

[01 15] The push_structured_event operation is used to post an event. It 
has one input parameter, a structured event as defined by the COS Notification 
specification. This operation has transactional behavior when used in the context 
of a transaction. The OIVIG Notification Service Specification contains further 
details of the structured event. 

2. Channel Factory intfirfanfi 

[0116] The ChannelFactory interface is used to find event channels. There 
is a single operation in this interface, find_channel. The syntax of the 
find_channel operation is shown below: 

Channel find_channel ( 

in ChannellD channel id 

) ; 
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[0117] The find_channel operation is used to find an event channel. There 
is currently only a single channel. The ChannellD that Is passed in must be set to 
TobLEvents::DEFAULT_CHANNEL. 

5 3. CORBA Notification Service Interface 

[01 18] This section contains a discussion of the operation defined by the 
COS CORBA Notification service interface API specification that are supported 
p by Event Server events. These operations are a subset of the complete set of 

py operations. This subset is a functionally complete API that can be used as an 

•"J 10 alternative to the Simple Events API. 

t"^ [0119] The CORBA Notification Service I nterface (hereafter referred to as 

the COS Notification). API is necessarily more complex than the Simple Events 
API. There are two reasons for this. First, the COS Notification API is complex, 
f ' Second, additional restrictions have been placed on the operations that are 

□ 1 5 supported. This API is provided for those who require that a standard API be 
used whenever possible even though it might produce little or no benefit beyond 
the Simple Events API. Applications that are developed to use this API are 
mostly portable, although not all of the Notification Service API may be supported 
to facilitate this. 

20 [0120] The model put forth by the OMG Notification Service Specification 
assumes that event channels or Event Brokers are constmcted programmatically 
at runtime. This view is counter to the way many commercial users will use an 
event system. Consequently, none of the services for constructing the event 
channels are included. The following is a list of the CORBA Notification Service 

25 operations that are implemented in full or in part in the Event Server provided by 
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add_constraints 

[0121] The add_constraints operator differs from the standard CORBA 
5 definition in the following ways. It can only be called once, must be called before 
the filter is added to the proxy object, and must consist of only a single constraint 
which has a single event type. 

destroy 

10 

create_filter 

[0122] The filtergrammar must be declared by setting the input argument 
constraint_grammar to TobLNotification;:Constraint_grammar. 

15 set_qos 

[0123] The set_qos operator is used to set the QOS. There are two 
components to the QOS, subscription type and the subscription name. The 
subscription type is set by constructing a name/value pair where the name is 
"TobLCosNotification^SUBSCRIPTION^TYPE" and the value is either 
20 PERSISTENT^SUBSCRIPTION, or TRANSIENT^SUBSCRIPTION. The 
subscription name is set by constructing a name/value pair where the name is 
'Tot)j_CosNotification_SUBSCRIPTION_NAME". and the value is a user defined 
string. 
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add_filter 

[01 24] The add_filter operator differs from the standard CORBA definition 
in the following ways. This operation can not be called after the Consumer is 
connected it can be called at most once, and when it is called the filter constraint 
expression must already be present in the filter. Only filters created by the Event 
Server implementation of the CosNotifyFilter: :FilterFactory create_filter method 
can be added. 

get_filter 

[0125] The FilterlD that is passed in must be a valid forthis proxy object. 
If the filter id is not valid for any proxy object associated with the event channel, 
then a FilterNotFound exception is thrown. Filter object references that are 
returned from this operation can not be used in comparison operations. Filter 
object references returned by this operation can be used by the 
CosNotifyFilter::Filter::destroy operations but are of little use othenfl^ise since they 
can not be modified or added to proxy objects. 

disconnect_structured_push_Supplier 

[0126] The disconnect_structured_push_Supplier operator does not stop 
event delivery instantaneously. After returning from this operator a Consumer 
may continue to receive events for a period of time. 

connect_structured_push_Consumer 
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[01 27] The cx)nnect_structured_push_Consumer operator differs from the 
standard CORBA definition in the following way. If the Consumer requires event 
filtering, then the filter must already be added to the proxy object prior to this 
operation being called. Othenvise, all structured events (i.e. unfiltered events) will 
5 be delivered. The effect of this operation is not instantaneous. There can be a 
delay between returning from this event, and the actual start of event delivery. 

push_structured_event 

[0128] The push_structured_event operator differs from the standard 
1 0 CORBA definition in the following ways: 

1 . The Priority specified in the variable header section of the event must 
be in the range 1-100 (vs. ^2,767 - 32,767 which is the specified range). 

2. Only fields in the Filterable Data portion of the event can be used in 
filter constraints. 

1 5 3. If event content (versus filtering on domain and type only) is required, 

then additional restrictions apply. 

disconnect_structured_push_Consumer 
20 connect__structured _push_Supplier 
MyType 

[0129] The MyType attribute returns "PUSH_STRUCTURED". 
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get_proxy_Supplier 

[01 30] The get_proxy_Supplier operator returns a proxy Supplier object 
created by this Consumer admin object. An input argument (ProxylD) uniquely 
identifies the proxy object. Callers should be aware that certain administrative 
operations can destroy the proxy object thus invalidating the ProxylD associated 
with it. If the ProxylD is invalid a ProxyNotFound exception is thrown. 

obtain_notification_push_Supp|jer 

[0131] The obtain_notification_push_Supplier Is used to create proxy 
push Supplierobjects. Since only structured events are supported the ClientType 
input argument must be set to "STRUCTURED_EVENr'. The Proxyl D returned 
should be durably stored so that following a failure it can be used to re-obtain the 
proxy object. 

obtain_notification_push_Consumer 

[01 32] The obtain_notlficatlon_push_Consumer is used to create proxy 
push Consumer objects. Since only structured events are supported the 
ClientType input argument must be set to "STRUCTURED_EVENT". The 
ProxylD returned should be durably stored so that following a failure it can be 
used to re-obtain the proxy object. 

default_Suppiier_admin 

[01 33] The default_Supplier_admin attribute returns the default Supplier 
admin object for the event channel. 
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default_filter_factory 

[01 34] The default_filter__factory attribute returns the default filterfactory 
object for the event channel. 

default_Consunier_admin 

[0135] The default_Consumer_admin attribute returns the default 
Consumer adnnin object for the event channel. 

get_event_channel 

[0136] The get_event_channel returns the EventChannel object. The 
ChannellD that is passed in must be set to TobLEvents: :DEFAULT_CHANNEL. 

push_structured_event 

void push_structured._event ( 

in CosNot if icat ion : : StructuredEvent event 

); 

[0137] The push_structured_event operation is provided by the 
Consumer. It is called by the system each time a structured event is delivered. 
The operation contains a single input parameter which is a structured event. This 
interface contains two additional operations, disconnect^ 
structured_push_Consumerand offer_change. These operations may never be 
invoked. The subscriber should provide stubbed out versions of these routines. 
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4, Channel Factory 

[01 38] As part of the application bootstrapping process it Is necessary to 
obtain an object reference to the channel factory (CosNotifyChannelAdnnin: 
:EventChannelFactory). This is done by using the resolveJnitial__references 
5 operation of the bootstrap object. Supportfor the following service Ids is added 
to the bootstrap object. 

S TRANSACTIONS 

G( [0139] The behavior with respect to transactions is the same for the 

U 10 CORBA and proprietary interfaces. The only operations which support 

rih 

transactional behavior are CosNotlfyChannelAdmin: 
rStructuredProxyPushConsumer: :push_structured_event and 
Tobj_SimpleEvents::push_structured_„events. All other operations can be used 

fll 

in the context of a transaction but workthe same inrespective of whether they are 

1 5 executed in a transaction or not. 

[0140] The behavior when posting an event is tied to the QOS of the 
Consumer. If an event is posted in the context of a transaction, and the event 
delivery QOS of the Consumer is persistent, delivery will be determined by the 
outcome of the transaction. That is, if the transaction is committed then delivery 

20 to Consumers is guaranteed. If the transaction is rolled back, then it will not be 
delivered. 

[0141] If an event is posted in the context of a transaction, and the event 
delivery QOS of the Consumer is transient, then a best-effort attempt will be 
made to deliver the event irrespective of the transaction outcome. That is, if the 
25 transaction is committed a best-effort delivery will be attempted. If the transaction 
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is rolled back then a best effort delivery may, or may not be attempted. This can 
result in phantom events being delivered to Consumers. There is no transaction 
context associated with event delivery. 

[0142] With both the SEI interface, and the CORBA Notification Service 
5 interface there are two Qualities Of Service (QOS): Persistent, and Transient, 
which are used to select a persistent or transient subscription mechanism 
respectively, as described above. 

[0143] The foregoing description of the present invention has been 
provided for the purposes of illustration and description. It is not Intended to be 

1 0 exhaustive or to limit the invention to the precise forms disclosed. Obviously, 
many modifications and variations will be apparent to the practitioner skilled in 
the art. The embodiments were chosen and described In order to best explain 
the principles of the invention and its practical application, thereby enabling 
others skilled in the art to understand the invention for various embodiments and 

1 5 with various modifications that are suited to the particular use contemplated. It 
is intended that the scope of the invention be defined by the following claims and 
their equivalence. 
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